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PREFACE 


Document Objectives 


This document describes how to install the Tool Kit PASCAL 
compiler on RSX-11M/M-PLUS and VAX/VMS host systems and is 
intended to be used by system managers. 


It also contains information specific to Release 1 of Tool Kit 
PASCAL and is intended to be used by software developers. 


Intended Audience 


The installation chapters of this document are intended _ for 
system managers but can be used by any user with system 
privilege. 


The release notes are intended for experienced programmers 


familiar with the PASCAL programming language and with the 
Professional 300 Series Developer's Tool Kit. 


Documentation Conventions 


red letters Red letters indicate words that you type (to 
distinguish them From words that’ the 
computer types). 


Associated Documentation 


® Professional Developer's Tool Kit PASCAL Language Reference 
Manual 


@ Professional Developer's Tool Kit PASCAL User's Guide 


AO OO CTS AAD 


® Professional Developer's Tool Kit User's Guide 


@® PRO/Communications Manual 


1.1 


The Tool Kit PASCAL 


CHAPTER 1 


INSTALLING TOOL KIT PASCAL ON RSX-11M/M-PLUS SYSTEMS 


THE DISTRIBUTION KIT 


following media: 


The 


distribution volume is available on the 


800 bpi (nine-track) DOS magtape 


1600 bpi (nine-track) DOS magtape 


RLO2 disk 


RKO7 disk 


distribution volume contains the following files: 


PROPAS .TSK 
PASLIB.OLB 


PASRES .TSK 


PASRES .STB 


PASERR .MSG 


~PROBLD.CMD 


RMSDEFS .PAS 


CGLDEFS .PAS 


MAPDEFS .PAS 


ERROR .PAS 


BELEMENTED.PAS 


The PASCAL compiler 

Non-sSharable portion of PASCAL OTS 

Sharable portion of PASCAL OTS. 

Symbol definitions for PASCAL OTS 

Message file 

Builds command files for RSX-11M/M-PLUS host 
RMS-11 mbeueace declarations 

CORE Graphics Library declarations 

Memory management directive declarations 
sample error handling routine 


Installation verification program 
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ELEMENTED.CMD IVP Application Builder command file 
ELEMENTED.ODL IVP Overlay Descriptor Language file 


ELEMENTED.INS IVP Installation command file 


REQUIREMENTS 


Tool Kit PASCAL requires approximately 900 blocks of free 
disk space. 


To install Tool Kit PASCAL, you must have already installed 


the Peripheral Interchange Program (PIP) and the File 
Exchange Program (FLX) to transfer files from magtape to 
disk. 


You must have access to a drive on which to mount’. the 
distribution volume. 


You must’ have access to a privileged login user 


identification code (UIC). If you do not have one, contact 
your system manager before beginning the installation. 


INSTALLING TOOL KIT PASCAL FROM MAGTAPE 


should install Tool Kit PASCAL on the same disk that contains 
Professional Developer's Tool Kit. 


Log in to your RSX-11M/M-PLUS system, uSing a privileged 
UIC e 


If you are uSing a DCL terminal, type: 


Cir rypeTTs Ag 
ne ad | is ie he 
Grel? ued elke odin Sewall dhe Ye Be de 


Be Rey 
a ae 


Load the Tool Kit PASCAL distribution volume into a drive, 
making sure that it's write-locked (make sure’ the the 
plastic ring has been removed before loading the tape). 


Mount the Tool Kit distribution volume. For example, type: 


Ge Pe apzaae % & fg, eysletign 
i id & bh der QB FF | “ , 


It is recommended that you now back up the distribution 
volume. Use any of the standard RSX-11M/M-PLUS backup 
utilities. 
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Copy the installation command file (TKIP.CMD) from_ the 


distribution volume to your default directory. If you are 
copying from an 800 bpi magtape, use the command: 


Te or GN, ae 
ow tb «3 Saeitr ehenl”  dyyaghs? 


If you are copying from 1600 bpi magtape, use the command: 


Execute the installation command file: 
> @TKIP 


The following will display on your screen. When the’ system 
prompts you, type in the name of the device on which the 
distribution volume is loaded. (If your host system does 
not have parent-offspring tasking, additional command lines 
will display.) 


2 SS eS aa eee a aS SS Sea a SSS ee Se SSeS eS SS eee a eee SS ea 
>; 

> “PR OOF Bo SS 2£°O NOAA DE D EVE GO P BOR -S T OO L 

a 

ys RS X-1i1M™/SM™M-# PLUS 

>} 

> Installation Procedure 

>} 

> PAS CAL VERS ION Te xg 2 

>} 

aaa a ae a a aa a a a a aaa a 
>} 

>; 

>* Device containing the distribution kit? [S]:MMOQ; 

>} 

par Copying the Tool Kit files 

ae 

>INS LB: [g,m]PROPAS 

>: Compiling a sample application 


>; This will take a few minutes 

>TKP ELEMENTED, ELEMENTED=LB: [1,5] ELEMENTED/XR/-TR/-CH 
-- lex 

éasyn 

» opt 

» gen 

swtsSet 

>: Successful Installation of Professional/Tool Kit PASCAL 
V1l.2-1 

>REM TKP 

>DEL ELEMENTED.OBJ; 

> 


ws @ 
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>DEL ELEMENTED.LST; 


ai 

2° : 

>PIP FLXFILIDX.CMD; /DE/NM 

>PIP FILIDX.CMD; /DE/NM 

>PIP DELFILIDX.CMD; /DE/NM 

2 SaaS Sa SSeS aa eS SS See Se eS eae eS ee eee ee ee Se SS Se ae ee 
>; 

>; The Professional Tool Kit has been installed. 

> Please unload and store all media. 

a | 

>; NOTE: If you have previously installed a version of the 
ye Professional Tool Kit, you may want to purge the 
>: earlier files to recover the disk space. Please 
G consult your release notes for a list of the 

De affected directories. 

>} 

>: ***k End of Installation Procedure *** 

2 RSS eS eee eS eae ee aa SS ee ee ee 
>@ <EOF> 

NOTE 
In the above message, [g,m] is the system UIC on 
your system. 
9. Dismount the Tool Kit PASCAL distribution volume: 
> DMO MMO: 

10. Unload the Tool Kit PASCAL distribution volume, and 
deallocate the drive if you allocated one earlier. 

ll. Store the Tool Kit PASCAL distribution volume in a_ safe 
place. 

12. Optionally, run VMR and install the Tool Kit PASCAL compiler 
(LB: [g,m]PROPAS.TSK). The compiler has the task name 
eal KP < : 

13. If you have a Professional, turn to Chapter 4 of this manual 
and follow the instructions For the Installation 
Verification Process. Otherwise, the installation of Tool 
Kit PASCAL is now complete. 

1.4 INSTALLING TOOL KIT PASCAL FROM DISK 

You should install Tool Kit PASCAL on the same disk that contains 


Deleting installation files 


1-4 


~2=e BSE BE WH =e 


~e BZ WE WES 
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the Professional Developer's Tool Kit. 


ae 


2e 


Log in to your RSX-11M/M-PLUS system, using a _ privileged 
UIC. 


If you are using a DCL terminal, type: 


ag a a 
geo a 
b> Eh Se dy 


$ SET TERM 


Load the Tool Kit PASCAL distribution volume into a drive, 
making sure that it’s write-locked. 


Mount the Tool Kit distribution volume. For example, type: 


> U DLO: 


It 1S recommended that you now back up the distribution 
volume. Use any of the standard RSX-11M/M-PLUS backup 
utilities. 


Copy the installation command file (TKIP.CMD) from the 
distribution volume to your default directory. 


> PIP SY:=DL0:[1,5]TKIP.CMD 


Execute the installation command file: 


The following will display on your screen. When the system 
prompts you, type in the name of the device on which the 
distribution volume is loaded. (If your host system does 
not have parent-offspring tasking, additional command lines 
will display.) 


>> PROFESS ITI ONAL DEVELOPERS T OO L 
>° RS X-1t1M/SM™M-PLUS 
>? Installation Proc e dure 


2s PR. S.C: Ay Aa V ERS ION i 


>* Device containing the distribution kit? [S]: DLO: 


>; Copying the Tool Kit files 


iS 


~~ 
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>; 

>INS LB: [g,m] PROPAS 

>; Compiling a sample application 

>; This will take a few minutes 

>TKP ELEMENTED, ELEMENTED=LB: [1,5] ELEMENTED/XR/-TR/-CH 
» lex | _ 


. syn 
» Opt 

- gen 

swkSt | 

>; Successful Installation of Professional/Tool Kit PASCAL 

Vig2=) 

>REM TKP 

>DEL ELEMENTED.OBJ; 

> 

>DEL ELEMENTED.LST; 

>? Deleting installation files 

Dee 7 : 

>PIP FLXFILIDX.CMD; /DE/NM 

>PIP FILIDX.CMD; /DE/NM 

>PIP DELFILIDX.CMD; /DE/NM 

oe ewe ee ee ee ee ee es ge ee a ; 
>} 7 
> The Professional Tool Kit has been installed. ; 
24 Please unload and store all media. ; 
a= | ° 
>; NOTE: If you have previously installed a version of the ; 
> Professional Tool Kit, you may want to purge the ; 
pe earlier files to recover the disk space. Please ; 
>; consult your release notes for a list of the ; 
>= affected directories. ; 
ya | j 
>: *** End of Installation Procedure *** : 
>} epee ---- -- - - - - = - - - - - - - - - - - = - = - = = - 5 5 5 + = - = - === - = - = - ; 


NOTE 


In the above message, [g,m] is the system UIC. on 
your system. 


9. Dismount the Tool Kit PASCAL distribution volume: 


> DMO DLO: 


10. Unload the Tool Kit PASCAL distribution volume, and 
deallocate the drive if you allocated one earlier. 
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ll. Store the Tool Kit PASCAL distribution volume in ae safe 


place. 

12. Optionally, run VMR and install the Tool Kit PASCAL compiler 
(LB: [g,m]PROPAS.TSK). The compiler has the task name 
" @ 6 »TKP" @ 


13. If you have a Professional, turn to Chapter 4 of this manual 


and follow the instructions for the Installation 
Verification Process. Otherwise, the installation of Tool 


Kit PASCAL is now complete. 


1.5 IF THERE IS AN ERROR 


The message "Tool Kit installation is now complete." does not 
necessarily mean that the installation was successful. Any 
appearance of system errors indicates an unsuccessful 


installation. 


If an error occurs while the installation is in progress, all 
files copied from the distribution volume will be deleted. For 
example: | 


Ppa Re ee Sa Sa eS SS Se Se ee ea ee ere Sa eee eee 
>} 
> PROFES S TONAL DEVELOPER S T OO L K I 
r RS X-1l1M™M™/SM™M-PLUS 
° Installation Procedure 
; PAS CAL VERS ION he ae 
>} 
2 PS SSeS SS Sa Sa eS ee ee eee ae SS eee eS eS 


>* Device containing the distribution kit? [S]: MMO; 


; Copying the Tool Kit files 
>; 
FLX -- I/O error 
MTO:[1,5]PROPAS.TSK -- I/O Error Code -13. 
>i 
> Installation Aborted - Cleanup in progress - Stand by 
>} 
Pa Please check the file LB: [g,m]PROPAS.TSK 
> If it was copied during this installation, please delete 
Les 
>i 
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> Deleting the installation files 
>i 
>PIP FLXFILIDX.CMD; /DE/NM 
>»PIP FILIDX.CMD; /DE/NM 
>PIP DELFILIDX.CMD; /DE/NM 
>; 
Par Tool Kit installation is now complete. 
>; 
>@ <EOF> 
NOTE 


In the above message, [g,m] is the system UIC on 
your system. 


Correct the error condition, then return to Section 1.2 of 
manual and proceed with the installation again. 


this 


ye | 


CHAPTER 2 


INSTALLING TOOL KIT PASCAL ON A VAX/VMS SYSTEM 


THE DISTRIBUTION KIT 


The Tool Kit PASCAL distribution volume consists of: 


The 


Two RX01 diskettes for VAX-11/780 systems. 


Two TU58 cartridges for VAX-11/750 systems. 


distribution kit contains the following files: 


PROPAS .EXE 
PASLIB.OLB 
PASRES .TSK 
PASRES .STB 
PASERR .MSG 
PROBLD.COM 
RMS DEFS .PAS 
CGLDEFS.PAS 
MAPDEFS.PAS 
BERROR.PAS 
ELEMENTED.PAS 
ELEMENTED.CMD 
ELEMENTED.ODL 


BELEMENTED.INS 


The PASCAL compiler 

Non-sharable portion of PASCAL OTS 
Sharable portion of PASCAL OTS 

Symbol definitions for PASCAL OTS 
Message file 

Builds command files for VAX/VMS host — 
RMS-1ll interface declarations 

CORE Graphics Library declarations 
Memory managment directive declarations 
Sample error handling routine 
Installation verification program 

IVP Application Builder command file 
IVP Overlay Descriptor engucas. ete 


IVP Installation command file 


Zi 


INSTALLING ON VAX/VMS 


2.2 REQUIREMENTS 


23 


Professional Tool Kit PASCAL requires approximately 900 disk 
blocks. 


You must have access to the console drive. 


You must have access to the privileged system manager's 
account SYSTEM. 


INSTALLING TOOL KIT PASCAL 


Proceed as follows at the console terminal. 


NOTE 


Some of the VMSINSTAL message lines shown in this 
terminal session have been folded in order to fit 
on a printed page. They will appear as_ single 
lines on your terminal. 


Log in to the system manager's account SYSTEM. 


Invoke VMSINSTAL: 


oR ee OP rR A Pe ey EHR we FER OS Se oe eee 
S @SYSSUPDATE:VMSINSTAI 
ee ee ee ee ee ee ee Te a 


VAX/VMS Software Product Installation Procedure. 


It is (current date/time string). 
Enter a question mark (?) at any time for help. 


Several *VMSINSTAL-W-warning messages may appear, followed 
by: 


* Do you want to continue anyway [NO]? yEs 

* Are you satisfied with the backup of your system disk 

[YES]? YES 

* Where will the distribution volumes be mounted: CSAl1: 
_CSAI1: allocated 


Enter the products to be installed 

from the first distribution volume set. 
*Products [EXIT]: PROPAS 
Please mount the first volume of the set on CSAIl:. 


INSTALLING ON VAX/VMS 


Remove the VMS console medium (if mounted) and load the first 
Tool Kit PASCAL distribution volume in the console drive. 


Are you ready? YES 
$MOUNT-I-~MOUNTED, PROPASOIL mounted on CSAI]1: 


The following products will be installed: 
PROPAS V1.2 
Beginning installation of PROPAS V1.2 at (time) 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
$BACKUP-I-RESUME, resuming operation on volume 2 
SBACKUP-I-READYREAD, mount volume 2 on CSAl: for reading 


Remove the first Tool Kit PASCAL distribution volume and load 
the second distribution volume in the console drive. 


Press return when ready: <RET> 
* Do you want to purge files 
replaced by this installation [YES]? No 


S$VMSINSTAL~I-MOVEFILES, 
Files will now be moved to their target directories... 


* 


Successful installation of PROPAS V1.2 at (time) 


Enter the products to be installed from the next distribution 
volume set. 

* Products [EXIT]: <RET> 

Please mount the console volume on CSAIL: 

Are you ready? YES 

$MOUNT-I-MOUNTED, CONSOLE mounted on CSAlI1: 


VMSINSTAL procedure done at (time) 


If you have a Professional, turn to Chapter 4 of this manual 
and follow the instructions for the Installation Verification 
Process. Otherwise, the installation of Tool Kit PASCAL is 
now complete. 


* If you have Tool Kit PASCAL V1.0 or V1.1 on your system, answer 


"YES" here. 


INSTALLING TOOL KIT PASCAL ON A PROFESSIONAL 350 SYSTEM 


CHAPTER 3 


3.1 THE DISTRIBUTION KIT 


The Tool Kit PASCAL distribution kit consists of two 
diskettes containing the following files: | 


PROPASCAL.TSK 
PASLIB.OLB 
PASRES .TSK 
PASRES .STB 
PROBLD.CMD 
RMSDEFS.PAS 
CGLDEFS .PAS 
MAPDEFS .PAS 
ERROR .PAS 
FLEMENTED. PAS 
ELEMENTED.CMD 
ELEMENTED.ODL 
ELEMENTED. INS 
ELEMENTED.HLP 
ELEMENTED .MNU 


ELEMENTED.MSG 


The PASCAL compiler 


Non-sharable portion of PASCAL OTS 


Sharable portion of PASCAL OTS (stub) 


Symbol definitions for PASCAL OTS 


Builds command files for PRO/Tool Kit 


RMS- 


ll interface declarations 


CORE Graphics Library declarations 


Memory managment directive declarations 


Sample error handling routine 


Installation verification program 


IVP 
IVP 
IVP 
IVP 
IVP 


IVP 


Application Builder command file 
pgenias Descriptor ganeuaue ee 
Installation command file 

nelp frame file 

menu frame file 


message file 


RX50 


INSTALLING ON THE PROFESSIONAL 350 


DCLPASCAL.HLIP PASCAL help file 


NOTE 
PASRES.TSK is only a "stub" for the Application 


Builder to use. The real OTS file are placed in 
[ZZSYS] at P/OS installation time. 


3.2 REQUIREMENTS 


® Professional Tool Kit PASCAL requires approximately 900 


blocks. 


® You must have a Professional 350 personal computer with 


PRO/Tool Kit installed. 
NOTE — 


If your Professional 350 system has P/OS 
Vi“ by the Tool Kit PASCAL installation 


verification procedure may fail. Turn tO 
Section 5.1.1 (first note) for details. 


3.3 INSTALLING TOOL KIT PASCAL 


1. Start up your Professional 350 system. 


disk 


the 


2. If have already installed an application named "ELEMENTED", 


use Disk/diskette Services to remove it. 
3. Invoke the PRO/Tool Kit. 
4. Insert distribution Sisketes "“PROPASCALI1" in DzZ1. 
ae eee eee rie diskette " PROPASCAL2" im: D222. 


6. Type: 


10. 


UT 


ear 
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The following will appear on your screen: 


$ 
S 
$ 


If you have installed a previous version, the following 
command will appear: 


Pascal Language Installation Procedure 


=e we we 


S REMOVE ...PAS 


The remainder of the installation will continue with the 
following: 


S INSTALL APPLSDIR:TKP/TASK=...PAS 

S$ ; Compiling the Installation Verification Program 

S This will take about 10 minutes 

S$ PAS ELEMENTED 

S ; Building the Installation Verification Program 

S$ LINK @ELEMENTED 

S INSTALL [ZZ2SYS]CGLFPU 

S ; Executing the Installation Verification Program 

S$ RUN ELEMENTED 

Turn to Section 4.5, Step 2 of this manual and follow the 
instructions for running the Installation Verification 
Process. 


The following will appear on your screen: 


S REMOVE/REGION CGLFPU 
S ; Installation complete 
S$ @ <EOF> 


Remove and store the distribution diskettes. 


CHAPTER 4 


INSTALLATION VERIFICATION PROCESS (IVP) 


The Installation Verification Process (IVP) verifies the 
successful installation of Tool Kit PASCAL. The process consists 
of successfully compiling, building, installing, and running a 
sample PASCAL application. The sample is a partially-developed 
Elementary Education Application that is intended only to 
exercise specific features of the Tool Kit. 


If you are using the Professional Developer's Tool Kit on a_ host 
RSX-11M/M-PLUS system, proceed to Section 4.1. 


If you are uSing the Professional Developer's Tool Kit on a= host 
VAX/VMS system, proceed to Section 4.2. 


If you are using the PRO/Tool Kit on a Professional 350 system, 
proceed to Section 4.3. 


4.1 BUILDING THE IVP WITH AN RSX-11M/M-PLUS HOST TOOL KIT 


The Installation Verification Process assumes that the 
Professional Developer's Tool Kit and Tool Kit PASCAL have been 
installed on your host RSX-11M/M-PLUS system and that’ the 
PRO/Communications application and the Fast Install program have 
been installed on your Professional. 


Proceed as follows: 
1. Start your Professional 300 Series system. 


2. Use Disk/diskette Services to create a directory named 
ELEMENTED on BIGVOLUME. 


3. Insert the Tool Kit RX50 diskette, volume label PRO/ APP 
DSKT BLDR V1.7 RX50 (the diskette that contains Fast Install 
and the Application Diskette Builder). 


10. 


The 


INSTALLATION VERIFICATION PROCESS 


Use File Services to copy the following files from 
TOOLKIT: [ELEMENTED] to BIGVOLUME: [ELEMENTED] : 


ELEMENTED.MSG 
ELEMENTED.MNU 
ELEMENTED.HLP 


Using the instructions in the PRO/Communications Manual, 
invoke the terminal emulator. 


Log onto your host RSX-11M/M-PLUS system. 


Compile the source file ELEMENTED.PAS. This file is 
provided with Tool Kit PASCAL and is automatically copied to 
LB:(1,5] when you install Tool Kit PASCAL on your host 
system. Type: 


> RUN $PROPAS 
PAS> ELEMENTED=LB: [1,5] ELEMENTED 


The file ELEMENTED.OBJ is produced by the compiler. 


To build the IVP, you must have the ODL file in your 
directory. Type: 


> PIP =LB: [1,5] ELEMENTED.ODL 


Invoke the Professional Application Builder. Type: 


> RUN $PROTKB 
PAB> @LB: [1,5] ELEMENTED 


The file ELEMENTED.TSK is produced by the Application 
Builder. | 


Using the instructions in the PRO/Communications Manual, 
transfer ELEMENTED.TSK and LB: [1,5] ELEMENTED.INS to 
BIGVOLUME: [ELEMENTED] on your Professional. 


Log off your host system. 


Using the instructions in the PRO/Communications Manual, 
exit from the terminal emulator. 


Proceed to Section 4.4. 


BUILDING THE IVP WITH A VAX/VMS HOST TOOL KIT 


Installation Verification Process assumes that the 


4-2 


INSTALLATION VERIFICATION PROCESS 


Professional Developer's Tool Kit and Tool Kit PASCAL have been 
installed on your host VAX/VMS system and that the 
PRO/Communications application and the Fast Install program have 
been installed on your Professional. 


Proceed as follows: 
1. Start your Professional 300 Series system. 


2. Use Disk/diskette Services to create a directory named 
ELEMENTED on BIGVOLUME. 


3. Insert the Tool Kit RX50 diskette, volume label PRO/ APP 
DSKT BLDR V1.7 RX50 (the diskette that contains Fast Install 
and the Application Diskette Builder). 


4. Use File Services to copy the following files from 
TOOLKIT: [ELEMENTED] to BIGVOLUME: [ELEMENTED] : 


ELEMENTED.MSG 
ELEMENTED.MNU 
ELEMENTED.HLP 


5. Using the instructions in the PRO/Communications Manual, 
invoke the terminal emulator. 


6. Log onto your host VAX/VMS system. 


7. Compile the source file ELEMENTED.PAS. This file is 
provided with Tool Kit PASCAL and is automatically copied to 
LB: [1,5] when you install Tool Kit PASCAL on your host 
system. Type: 


$ RUN SYSSSYSTEM: 


The file ELEMENTED.OBJ is produced by the compiler. 


8. To build the IVP, you must have the ODL file in your 
directory. Type: 


S COPY LB:[{1,5]ELEMENTED.ODL * 


9. Invoke the Professional Application Builder. 


SYSSSYSTEM: PROTK 
B: {1,5]ELEMENTED 


The file ELEMENTED.TSK is produced by the Application 
Builder. 
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10. Using the instructions in the PRO/Communications Manual, 
transfer ELEMENTED.TSK and LB: [1,5] ELEMENTED.INS to 
BIGVOLUME: [ELEMENTED] on your Professional. 


ll. Log off your host system. 


12. Using the instructions in the PRO/Communications Manual, 
exit from the terminal emulator. 


13. Proceed to Section 4.4. 


4.3 BUILDING THE IVP WITH A PRO/TOOL KIT 


If you are uSing a Professional 350 system, the Tool Kit PASCAL 
installation procedure compiles, builds, and runs the IVP for 
you. If you want to perform the process yourself, proceed as 
Follows: 


1. Start your Professional 300 Series system and run _ the 
PRO/Tool Kit. 


2. Type these commands in the order shown: 


ee FE Se eye eye ges ge 
a ee oe, & F 8p 2 a & 
9G bk Ee AU dk q 


3. Proceed to Section 4.4. 


4.4 INSTALLING THE IVP 


1. Select Fast Install from the appropriate menu. When Fast 
Install prompts for the disk directory name in which the 
application resides, type: 


10h 
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When the Application Group Menu appears, select a group and 
press DO. 


A form will appear displaying the name of the application, 
and the name of the group. Follow the instructions on the 
form and press DO. 


Proceed to Section 4.5. 


RUNNING THE IVP 


Select ELEMENTED - PASCAL IVP from the menu where you 
installed it. 


A static, Single-choice menu titled "Elementary Education 
Application" will appear (see Figure 4-1). 


Press HELP. A help menu titled "Help-= on Elementary 
Education Application" will appear (see Figure 4-2). 


Select Reading the Report Card. A help text frame will 
appear (see Figure 4-3). 


Press RESUME to return to the first menu. 


Select Geography. A multiple-choice menu titled "Course: 
Geography of North America" will appear (see Figure 4-4). 


Using the SELECT key, select all of the options (including 
the incorrect ones) and press DO. An error message will 
appear and, after a few seconds, the multiple-choice menu 
will reappear. 


Select Mt. Rushmore, Mt. Washington, Mt. Hood, Grand 
Teton, Mt. Rainier, Mt. St. Helens, Mt. McKinley, and 
press DO. A message indicating you have supplied the 
correct answer will appear. 


After a few seconds, a map of the Northeastern United States 


will appear on your screen (see Figure 4-5). This completes 
the Installation Verification Process. Tool Kit PASCAL has 


been successfully installed. 


Proceed to Chapter 5 for information on using Tool Kit 
PASCAL with the PRO/Tool Kit. 
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ELEMENTARY ECUCSTION GeP_TCATICN 


This application offers elementary education in seven 
Fields of study. Select ane of the courses listed hare: 


Biology 

Computer Science 
Geography 
Government 
History 
Literature 
Mathematics 


Make a selection and press the DO key: 


Figure 4-l: Elementary Education Application 


You can display helpful information about the subjects listed below. 
Select an option then press the CO key. Prass the RESUME key to return 
to the Main Menu. 

COMPLETING TEST AND QUTEZES 

READING THE REPORT CARD 

SELECTING COURSES 

WSING THE MAP 


Make a selection and press the (CO key: 


Figure 4-2: Help on Elementary Education Application 
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You can display helpful information about the subjects listed below. 
Select an option then press the BD key. Press the RESUME key to return 
to the Main Menu. 


COMPLETING TEST AND QUIZZES 
READING THE REPORT CARD 
SELECTING COURSES 

USING THE MAP 


The Report Card presents an objective evaluation of your work in courses 
offered by the Elementary Education Application. The Report Card lists 
all the courses you have taken. For sach course, it indicates the num- 
ber of correct and incorrect answers given on tests and quizzes, the 
number of times the course was taken, the date of the last quiz and test 
taken, and, if the course was completed, the passing or failing grade. 


Figure 4-3: Reading the Report Card 


Hat soa AP ere SPAT SS kare rs 
SEGonerA:y CF NORTH aMeRicG | 


This course covers rivers, lakes, and mountains. The first topic is 
Pe mountains. The mountains listed below area located in different parts of 
PB the world. Select all the mountains located in North America: 


MT. RUSHMORE 
MT. WASHINGTON 
MT. HOOD 
GRANG TETON 
MT. RAINIER 
MT. FUJI 
EILIMANJARO 
PC Mba Ste HPVENS 
Pee MTs MCRINLEY 


Choose one or more options with the SELECT key and press the OO key: 


Select up to 3 items 
{ chosen ? 


Figure 4-4: Course: Geography of North America 
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Figure 4-5: Map of Northeastern United States 


CHAPTER 5 


RELEASE NOTES 


5.1 USING TOOL KIT PASCAL WITH THE PRO/TOOL KIT 


Using Tool Kit PASCAL with the PRO/Tool Kit is similar to using 
Tool Kit PASCAL with RSX-11M/M-PLUS or VAX/VMS DCL without the 
File transfer step. This section describes the differences. 


5.1.1 Compiling Programs 


Before invoking the PRO/Tool Kit PASCAL compiler, type: 


$ 


The PASCAL command format is described in the PRO/Tool Kit 
Command Language/Utilities Manual. The defaults are: 


/CHECK=ALL 
/CODE=FPP 
/DEBUG=TRACEBACK 
/NOLIST 
/NOMACHINE CODE 
/OBJECT 
/NOSTANDARD 
/NOXRAY 


If you omit a file name, the PAS> prompt will appear and you’ can 
enter a command in the format described in the Tool Kit PASCAL 
User's Guide. For example: 


S PASCAL 
PAS> FELEME 
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Notes 


@e If your Professional 350 system has P/OS V1.5, the Tool Kit 
PASCAL compiler may produce apparently invalid error messages 
because of inadequate memory. Tf that happens, you can 
obtain more memory by following these steps: 


1. Start the PRO/Tool Kit and set your default directory to 
APPLSDIR. 


Ze (EOLe START .CMD and comment out any tasks that are not 


essential to your program development cycle. For 
example, if you do not use the DIFFERENCES command, add 


semicolons as shown in bold: 


Install the Compare Utility - DIFFERENCES command 


e-DISABLE QUIET 
»~IFNINS ...CMP INSTALL APPLSDIR:CMP 
~ENABLE QUIET 


Se ee *~E ~“E Wes 


Do not comment out the Professional Application Builder. 


3. Return to the Main Menu (use the EXIT command) and 
restart the PRO/Tool Kit. 


4. If you find that you need one of the DCL commands that no 
longer work, type "RUN Sprogram", where "program" is the 
name of the task you commented out. For example, you 
could say "RUN SCMP". | 


@ Because of a slight DCL incompatibility, /MACHINE CODE=file 
results in an error. To use this option, specify 
/MACHINE CODE and allow the output (.MAC) file to default to 
the same name as the input file. 


@ You cannot use /OBJECT and /MACHINE CODE at~ the same time. 
If you want /MACHINE CODE, specify /NOOBJECT. 


5.1.2 Installing Applications 


The following information is also present in the Tool Kit User's 
Guide. To install a Tool Kit PASCAL application, you can use 
Disk/diskette Services, Fast Install (as demonstrated in the 
IVP), or PRO/Tool Kit DCL. Ultimately, end users will use 
Disk/diskette Services to install your application. 


It is recommended that you use Fast Install during the 


eZ 
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development process because your application's run-time context 
will be similar to that produced by Disk/diskette Services. 


users. This 1S particularly important if your application opens 
files: your application can use PROLOG to translate APPLSDIR- in 
order to specify the location of its files. Also, your 


installation command file can use ASSIGN MENU and ASSIGN HELP to 
open menu and help files and RDMSG will work as documented. 


If you use the DCL INSTALL command, APPLSDIR will refer to the 
PRO/Tool Kit directory, rather than your application directory, 
because the PRO/Tool Kit is itself an application. Thus, you 
must use one of the following methods to specify the locations of 
Files: 


® Write your source code with exact file specifications. You 


will have to change it and recompile when you test your 
application with Fast Install or Disk/diskette Services. 


® Copy the application files into the PRO/Tool Kit directory so 
that APPLSDIR will "point" to the right place. This solution 
will not require any code change when you test your 
application with Fast Install or Disk/diskette Services: you 
simply copy the files to a different directory. 


NOTE 


Do not reassign the logical name APPLSDIR. To do 
SO can cause the PRO/Tool Kit to stop working. 


The first method is preferable because it is undesirable to 
change the contents of the PRO/Tool Kit directory. If you remove 
the PRO/Tool Kit (to install a new version or whatever), 
extraneous files can cause the removal to fail. 


5.2 NEW FEATURES 


1. A routine can be declared as EXTERNAL in the same module 
that contains the routine definition (heading and body). 
The formal parameter lists must be identical. 


This occurs primarily when uSing an include file to declare 
external routines. For example, the include file 
EXTERNALS.PAS declares, among other things: 


procedure foo (a,b,c : integer); external; 


The module that actually contains the procedure is: 
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module five; 
S$include ‘EXTERNALS/nolist' 


[GLOBAL] procedure foo (a,b,c : integer); 
begin | 


end } foo }?; 
end {| five }. 


This module is valid, even though the procedure heading 
appears twice. In Tool Kit PASCAL V1.0, if a routine is 
declared as external and defined in the same module, the 
routine definition heading cannot have a formal parameter 
list. 


NOTE 


Although the external declaration and the global 
definition of a procedure can occur in one 
compilation unit, the same is NOT true of variables. 
An external declaration and a global definition of a 
variable in the same unit will result in an error. 


The compiler now supports RAD50 string constants which are 
useful when calling P/OS executive directives. The syntax 
is Similar to that for octal, hexadecimal, and binary 


constants. The flag character is "R". 


A RAD50O string constant of fewer than three characters 
returns an integer constant (one word). A RAD50O string 
constant of four to six characters returns a long integer 
constant (two words). For example: 


var 
i : integer; 1 : long_integer; 


begin 
1 := %$R'GEN'; 60726226" 4 
1 := S$R'GENPAR'; { %0'26226' %0'62072' } 
end; 
The compiler now allows expression results (including 


function calls and elements of packed structures) to be 
passed as actual parameters to formal VAR parameters 
declared with the READONLY attribute. This feature will 
make CORE Graphics Library programming easier because you no 
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longer have to declare and use an explicit temporary 
variable for expression results. When you pass an 
expression to a [READONLY] VAR parameter, PASCAL pushes the 
expression value onto the stack and creates a pointer to 
that location. 


The compiler now Supports default parameters for SEQI1 
procedures to facilitate the use of P/OS services directly 
from Pascal. 


If a SEQI1 procedure call fails to specify actual parameters 
for any of the formal parameters declared with the procedure 
header, PASCAL will pass minus one (-1) as the address of 
the missing parameter. 


COMPILER NOTES 


On VAX/VMS systems, compiler command lines behave 
incorrectly when your default device is a rooted directory 
such as SYSS$SYSROOT. To avoid the problem, include "SY:" in 
each file specification that does not already contain a 
device name. 


The default floating point option for Tool Kit PASCAL V1.1 
or later is /FP (/CODE=FPP), rather than /-FP, as in V1.0. 


The include file RMSDEFS.PAS contains type declarations for 
PRO/RMS-11 data structures well as the PRO/RMS-11 completion 
and fatal error codes. Unless you intend to use the data 
structures, it is recommended that you create a new file 
containing only the PRO/RMS-11 completion and fatal error 
codes and use it instead. This will improve compiler 
performance. 


On a VAX/VMS system, if your disk usage iS close to your 


quota, the compiler may hang or generate spurious error 
messages. To avoid this problem, keep at least 1500. 
available blocks. Large compiles may require more. 


If you get the compiler diagnostic message: 
"Register <n> not saved during actual parameter list." 


where <n> is the register which was not saved, you should 
Simplify the surrounding environment. Several registers are 
required to push large structures onto the stack so if the 
problem is a large value param, it may help to use a VAR 
param instead as this will only push the address of the 
item. Another heavy register user is intermediate level 
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data references. That is, accessing data declared in 
procedures enclosing the one giving the problem. Accessing 
data at the outer most level (PROGRAM or MODULE level) is 
not a problem as_ the stack does not have to be walked to 
locate the data. Use of the /CHECK option also uses’ extra 


registers. 


GENERAL DOCUMENTATION NOTES 


The Professional Application Builder requires that all 
identifiers declared with the GLOBAL attribute be unique 
within the first Six characters. 


All Tool Kit PASCAL programs contain a GLOBAL procedure 
named ERROR that receives control when a run-time error 
occurs. By default, the Professional Application Builder 
extracts your program's ERROR procedure from the Tool Kit 
PASCAL object module library (PASLIB.OLB). That ERROR 
procedure displays information useful for debugging your 
application. The source code for that procedure (ERROR.PAS) 
is included in the distribution kit. 


When you supply your own GLOBAL procedure named ERROR, it 
will receive control when a run-time error occurs. It is 
recommended that you use your own ERROR procedure. If an 
unanticipated run-time error occurs, your application can 
display useful information and instructions for the user. 


NOTE 


When you declare your own ERROR procedure, compile 
/NOCHECK and /NODEBUG (/-CH/-TR). 


Input/foutput on aerelative file cannot cause the EOF 
Function to return TRUE. Thus, when working with relative 
files, you must use some other means to detect end-of-file. 
Alternatives are: 


@ Put a sentinal record in the file. This is the simplest 
solution. 


@® Write a user-action OPEN routine that sets a maximum 
cell number. The default maximum cell number is 2 ~ 3l 
which, for all intents and purposes, is infinity. 
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@® Store the number of the last record written to the file 
somewhere. 


@ If you know that the valid portion of the file does not 
contain deleted records, you can check the UFB function 
for TRUE or the STATUS function for a "record not found" 
error. 


If the Professional Application Builder returns an undefined 
symbol error for a symbol such as "$B81" or "$B83", edit 
your .ODL file and add an explicit OTS reference to the 
appropriate segment. For example, if segment FOO2 had an 
undefined symbol error, you would add the characters’ shown 


in bold: 


eROOT FOO-PAS LB-~RMSROT-OVRLY 
OVRLY: ~FCTR *(OV1,0V2,0V3) 


OV1: ~FCTR FOO] 
OV2: -FCTR FOO2-PASLB 
OVS: »FCTR FOO3 


PASLB: .FCTR LB: [1,5] PASLIB/LB 
@LB: [1,5]RMSRLX 
» END 


LANGUAGE REFERENCE MANUAL NOTES 


Page 2-18, paragraph two: replace "Sections 7.5.2 and 
7.5.3" with "Sections 7.17 and 7.9". 


Page 3-8, paragraph one: replace "Section 10.21" with 
"Section 10.13". 


Page 6-19, Section 6.6.4, paragraph two: replace "Section 
10.7* With. “Section, 10:97" 


Page 6-19, Section 6.6.4, paragraph three: replace "Section 
10.8" with "Section 10.11". 


Page 7-9, Section 7.17, example program: replace "Ptr = 
Node;" with "Ptr = “Node;". 


Page 7-10, example program in first note: replace "Ptr = 
Node;" with "Ptr = ~“Node;". 


Page 8-10, Section 8.10, Positional format: replace 
"default file name" with "default file spec". 
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Page 8-10, Section 8.10, Non-positional format: replace 
"FILE SHARING" with "SHARING". 


Page 8-10, Section 8.10, Non-positional format: replace 
"default file name" with “default file spec”. 


Page 


8-11, Table S15 replace "FILE SHARING" with 


"SHARING". 


Page 8-15, Section 8.10.10: replace "FILE SHARING" with 
"SHARING". | 


The OPEN procedure has several parameters that are shown in 
Section 8.10 (syntax diagram) and Table 8-1 (Summary of OPEN 
Procedure Parameters) but not described in detail. They 


ares 


DEFAULT 


The DEFAULT parameter provides a default file 
specification for the FILE NAME parameter. When RMS-1l1 
parses the FILE NAME, it uses the DEFAULT value to fill 
in any missing fields. If the DEFAULT parameter is not 
present, RMS-11 uses the P/OS current file 
specification. Refer to the Tool Kit User's Guide for 
detailed information on file specifications. 


FILE SIZE 


The FILE SIZE parameter specifies an initial file 


allocation in 51l2-byte blocks. The default FILE SIZE 


value is three blocks. Use this parameter whenever you 
have a reasonable idea of how much space a file will 
require. It 1s much more efficient to specify a large 
initial allocation than to allocate additional blocks as 
needed. 


FILE EXTENSION 


The FILE EXTENSION parameter specifies the number of 
512-byte blocks to allocate when PASCAL must obtain 
additional space for a file. The default FILE EXTENSION 
value is five blocks. 7 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL 
will use comments submitted on this form at the com- 
pany’s discretion. If you require a written reply and 
are eligible to receive one under Software Perfor- 
mance Report (SPR) service, submit your comments 
on an SPR form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of reader that you most nearly represent. 
[} Assembly language programmer 
L_] Higher-level language programmer 
L] Occasional programmer (experienced) 
[_] User with little programming experience 
] Student programmer 
_] Other (please specify) 
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